Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-013 |
| Deskripsi | Laporan kartu stok: menelusuri pergerakan stok per barang dalam periode, melihat masuk keluar per transaksi, dan mengekspor hasil |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka laporan Kartu Stok dari kelompok Laporan Stok dan Persediaan.
- User memfilter periode, barang, cabang, modul, posisi stok, dan quantity.
- User melihat kartu stok per barang: tanggal, transaksi masuk/keluar, dan saldo berjalan.
- User membuka dokumen sumber transaksi dari baris kartu stok.
- User mengekspor kartu stok ke Excel jika memiliki izin.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan kartu stok multi barang sesuai filter periode dan kriteria |
| FR-02 | User dapat memfilter barang, cabang, modul, posisi, dan quantity |
| FR-03 | Setiap kartu menampilkan baris transaksi beserta saldo akhir |
| FR-04 | User dapat membuka dokumen sumber transaksi dari baris kartu |
| FR-05 | Pemuatan barang dilakukan bertahap per halaman lokal agar tidak membebani layar |
| FR-06 | User dengan izin Excel dapat mengekspor kartu stok ke file Excel |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Membuka laporan kartu stok |
| UC-02 | Memfilter dan menampilkan kartu stok |
| UC-03 | Membuka dokumen sumber transaksi kartu stok |
| UC-04 | Mengekspor kartu stok ke Excel |
4. Use Case Scenario
UC-01 : Membuka laporan kartu stok
| Aktor | User stok / akuntansi |
| Deskripsi | User membuka halaman Kartu Stok dari hub laporan stok |
| Prekondisi | User sudah login, brand aktif, dan memiliki izin #lap-kartu-stok |
| Alur utama | 1. User membuka menu Laporan lalu tab Stok dan Persediaan. 2. User memilih kartu Laporan Kartu Stok. 3. Sistem membuka halaman filter tanpa data. |
| Alur negatif | - Jika user tidak punya izin #lap-kartu-stok, kartu tidak tampil di hub. |
| Bisnis rule | - Tombol kembali mengarah ke hub /laporan-stok. |
| Postkondisi | Halaman Kartu Stok terbuka |
| Trigger | User memilih kartu Laporan Kartu Stok |
| Kode FR | FR-01 |
UC-02 : Memfilter dan menampilkan kartu stok
| Aktor | User stok / akuntansi |
| Deskripsi | User menampilkan pergerakan stok per barang sesuai filter |
| Prekondisi | Halaman Kartu Stok terbuka |
| Alur utama | 1. User mengisi periode, barang, cabang, modul, posisi, dan quantity bila perlu. 2. User menekan tombol tampilkan. 3. Sistem memuat daftar barang terkait lalu mengambil kartu stok multi barang. 4. Sistem menampilkan per barang: baris tanggal, masuk, keluar, dan saldo akhir. |
| Alur negatif | - Jika filter belum diisi, muncul "Lengkapi filter untuk menampilkan data". - Jika data kosong atau gagal, muncul notifikasi "Data yang anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Jika barang dipilih, id barang dipakai langsung pada permintaan multi stok. - Jika barang tidak dipilih, daftar barang dihitung lewat hitungan kartu stok lalu dipaginasi lokal. - Setiap chunk barang memicu permintaan report-stok/multi. |
| Postkondisi | Kartu stok per barang tampil |
| Trigger | User menekan tombol tampilkan |
| Kode FR | FR-01 FR-02 FR-03 FR-05 |
UC-03 : Membuka dokumen sumber transaksi kartu stok
| Aktor | User stok / akuntansi |
| Deskripsi | User menelusuri dokumen asal dari baris kartu stok |
| Prekondisi | Kartu stok sudah tampil |
| Alur utama | 1. User mengklik referensi transaksi pada baris. 2. Sistem membuka halaman lihat dokumen di tab baru sesuai modul. |
| Alur negatif | - Jika modul tidak dipetakan, tautan tidak dibuka. |
| Bisnis rule | - Modul Pembelian membuka halaman pembelian; Pembelian Import memakai query type=import; Penjualan membuka halaman penjualan. |
| Postkondisi | Dokumen sumber terbuka di tab baru |
| Trigger | User mengklik referensi transaksi |
| Kode FR | FR-04 |
UC-04 : Mengekspor kartu stok ke Excel
| Aktor | User dengan izin Excel kartu stok |
| Deskripsi | User mengunduh kartu stok dalam format Excel |
| Prekondisi | User memiliki izin excel pada #lap-kartu-stok |
| Alur utama | 1. User menekan tombol export Excel. 2. Sistem meminta file export multi stok ke server. 3. Browser mengunduh file "kartu-stok.xlsx". |
| Alur negatif | - Jika permintaan gagal, muncul notifikasi error. |
| Bisnis rule | - Jika filter kosong, sistem memakai default periode bulan berjalan dan stok "Semua Stok". - Export memakai endpoint khusus multi-export, bukan susunan Excel di browser. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan tombol export Excel |
| Kode FR | FR-06 |
5. Data Flow Diagram
DFD-01 — Alur data kartu stok
6. Sequence Diagram
SD-01 — UC-01 : Membuka laporan kartu stok
SD-02 — UC-02 : Memfilter dan menampilkan kartu stok
SD-03 — UC-03 : Membuka dokumen sumber transaksi kartu stok
SD-04 — UC-04 : Mengekspor kartu stok ke Excel
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
POST /report-stok/multi | existing | - |
GET /report-stok/multi-export | existing | - |
GET /sku/all/kartu-stok-count | existing | - |
POST /sku/get-bulk-sku | existing | - |